Skip to content

Finish the repo: production servers, README, cleanup - #13

Merged
mattiashem merged 1 commit into
mainfrom
docs-complete
Nov 8, 2026
Merged

mattiashem merged 1 commit into
mainfrom
docs-complete

Conversation

@mattiashem

Copy link
Copy Markdown
Contributor

Why

The repo worked but wasn't finished. Both servers ran on development web servers, the README didn't say that you must add your own authentication, and old files were still lying around.

What changed

  • README rewritten. It covers:
    • what the mapserver does and how it works, with a diagram
    • Authentication is your job: the UI and the tile server have no login. Keep the UI private, and protect tiles with network rules, because the ollebo.com viewer loads tiles without credentials.
    • Hosting help: our partner Ankra can host it in Sweden or the US
    • install with Docker and Helm, connecting to ollebo.com, configuration, storage, development, releases and known limitations
  • Production servers: the web UI and Terracotta now run under gunicorn instead of flask run and terracotta serve. The UI has no request timeout, because a map builds inside the request. Tile workers are set with the new terracotta.workers (default 4).
  • .env.example: the key is used now, and the API URL no longer has /v1.
  • Cleanup: removed dead code (listTiles.py, tiles.html), the unused web/ folder and four committed .pyc files.

Testing

I built the image and ran it as the chart does: one container for the UI and one for Terracotta, sharing volumes.

  • Both servers start under gunicorn: 1 UI worker, 4 Terracotta workers
  • A GeoTIFF in maps/ is built on startup
  • Upload, build (7 s for the test file), viewer and Settings all work, with no errors in the log
  • A tile request returns 200 image/png with Access-Control-Allow-Origin: https://dash.ollebo.com
  • helm lint passes, and the chart renders with TC_DRIVER_PATH and the gunicorn command
  • docker compose config validates
  • Not yet run on a cluster

🤖 Generated with Claude Code

https://claude.ai/code/session_01AwkBcZCmo27zHnnRnAcKiy

- Run the web UI and the tile server under gunicorn instead of Flask's and
  Terracotta's development servers. The UI has no request timeout, because
  a map builds inside the request.
- Rewrite the README: what the mapserver does, how it works, that you must
  bring your own authentication, and hosting help from our partner Ankra.
- Update .env.example: the key is used now, and the API has no /v1.
- Remove dead code (listTiles.py, tiles.html), the unused web/ folder and
  committed .pyc files.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01AwkBcZCmo27zHnnRnAcKiy
@mattiashem
mattiashem merged commit 5c14e1f into main Nov 8, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants